home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / edit / wpgrab16.zip / WPGRAB.DOC < prev    next >
Text File  |  1988-02-28  |  17KB  |  580 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                      WPGRAB
  10.  
  11.  
  12.                               P A T R I Q U I N ' S
  13.  
  14.                        Word Processing File Selection Aid
  15.  
  16.  
  17.                                        by
  18.  
  19.  
  20.                                 Norm J. Patriquin
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.                                   User's Guide
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.                         Patriquin's BBS  --  714-369-9766
  38.  
  39.  
  40.  
  41.  
  42.  
  43.                                   March 1, 1988
  44.  
  45.  
  46.  
  47.  
  48.                         Copyright 1987 by Norm Patriquin
  49.  
  50.                                 Table of Contents
  51.  
  52.  
  53.  
  54.      WPGRAB  --  Select file for Word Processing activity  . . . . . . .    1
  55.  
  56.      Command Parameters  . . . . . . . . . . . . . . . . . . . . . . . .    3
  57.  
  58.      Supplied DOS batch files  . . . . . . . . . . . . . . . . . . . . .    5
  59.  
  60.      Registering WPGRAB  . . . . . . . . . . . . . . . . . . . . . . . .    6
  61.  
  62.      WPGRAB 1.6 Registration . . . . . . . . . . . . . . . . . . . . . .    7
  63.  
  64.      Reporting Problems with WPGRAB 1.6  . . . . . . . . . . . . . . . .    8
  65.  
  66.      Maintenance Log . . . . . . . . . . . . . . . . . . . . . . . . . .    9
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.                                           2
  103.      WPGRAB  --  Select file for Word Processing activity
  104.  
  105.  
  106.      For some  time now I have wanted a facility in Word Perfect1 to allow me
  107.      to continue processing either the last  document I  was working  with or
  108.      one of  the more  recent ones.   I  sometimes lose  track of what I have
  109.      named files and have to go searching through directories looking to find
  110.      the ones I need.
  111.  
  112.      This utility was developed to make my life easier.  Maybe it can benefit
  113.      you too.  WPGRAB simply scans  the  DOS  directory  to  locate  the most
  114.      recently updated  files.  It then presents them to you so you can review
  115.      and select a file from them to process.  Once you have  selected a file,
  116.      WPGRAB places  a command  with the filename in it in a DOS batch command
  117.      file to be executed.   The  following batch  file is  an example  of its
  118.      operation.
  119.  
  120.      Batch file  named WPS.BAT.   A  typical use would be to just type in WPS
  121.      and let it do the work, but you  might also  give it  a filename pattern
  122.      and qualify its search.
  123.  
  124.  
  125.                     cd\wp
  126.                     echo off
  127.                     cls
  128.                     wpgrab %1 /C:\perfect\wp
  129.                     if errorlevel 2 goto error
  130.                     wpgrab$$
  131.                     :error
  132.  
  133.      Assume  we  started  WPGRAB  with  the  WPS command.  WPGRAB scanned the
  134.      directory and found  the  most  recent  files  to  processed.    It then
  135.      displays a screen displaying the following information.
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.                          
  150.  
  151.           1    Word  Perfect  is  a  registered  trademark  of  Word  Perfect
  152.                Corporation.
  153.  
  154.  
  155.                                           1
  156.      *****************************************************************
  157.  
  158.      WPGRAB   1.6             Copyright 1987       by: Norm Patriquin 
  159.      -----------------------------------------------------------------
  160.      List of the 15 most recently updated files.       Use /h for HELP
  161.      -----------------------------------------------------------------
  162.            A --  PCOPY.MAS      11SEP87   6:29a      931 
  163.            B --  ALTF.MAC       11SEP87   6:32a        7 
  164.            C --  L.BK!          13SEP87   1:49p      931 
  165.            D --  L.LTR          13SEP87   2:01p     1052 
  166.            E --  X.BK!          13SEP87   2:02p      931 
  167.            F --  PS.BK!         13SEP87   2:21p      959 
  168.            G --  PS.LTR         13SEP87   2:28p      987 
  169.            H --  PDISK.BK!      13SEP87   2:32p     1320 
  170.            I --  PDISK.LTR      13SEP87   2:38p     1332 
  171.            J --  PCOPY.LTR      13SEP87   2:43p      943 
  172.            K --  PPRINT.BK!     13SEP87   3:09p      820 
  173.            L --  PPRINT.LTR     13SEP87   3:11p      846 
  174.            M --  X              13SEP87   3:12p      846 
  175.            N --  WPSELTMP.BAT   17SEP87  10:12p       20 
  176.            O --  {WP}BACK.1     17SEP87  10:30p    11844 
  177.       
  178.      Press a letter to select a file from the list, <ESC> to exit, or 
  179.      <ENTER> to select the most recent file ({WP}BACK.1) 
  180.       
  181.      Waiting for your selection...  
  182.  
  183.      *****************************************************************
  184.  
  185.  
  186.      WPGRAB now waits for you to select the file to be processed.
  187.  
  188.      .    Press <Enter> to automatically select the most recent file found in
  189.           the directory.  This is the filename at the bottom of the list.
  190.  
  191.      .    Press a  letter from A to O to select one of the files shown on the
  192.           display.  These  files  are  listed  sorted  by  date  and  time in
  193.           ascending order.
  194.  
  195.      .    Use the up and down arrow keys to select the file to process.  Then
  196.           press the <enter> key to begin processing.
  197.  
  198.      .    Press <ESCape> to terminate the process and not select any file.
  199.  
  200.      .    Press </> to start the command without a filename.
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.                                           2
  209.  
  210.      WPGRAB can actually be used for interfacing to any command  that accepts
  211.      individual filenames  as input.  Consider using it for editors, listers,
  212.      word processors, and other utilities.
  213.  
  214.  
  215.      Command Parameters
  216.  
  217.      WPGRAB has a few simple  command  parameters  to  modify  its operation.
  218.      Here is how they operate:
  219.  
  220.  
  221.           COMMAND FORMAT:
  222.  
  223.           WPGRAB [fspec]      [/C:xxxx]  [/L]  [/D]  [/H]  [/X]
  224.                               [/SS]  [/SC]  [/SV]  [/SA]
  225.  
  226.  
  227.           [fspec]   Enter the  DOS file  specification for  the directory and
  228.                     file names to be  searched.    If  no  directory  name is
  229.                     specified the current directory will be searched.
  230.  
  231.           /C:xxx    WPGRAB  normally  builds  a  WP  command  followed by the
  232.                     pathname/filename selected.  If you desire  to use WPGRAB
  233.                     for  another  utility,  specify  the -C command parameter
  234.                     followed by the command  to be  used.   This can  also be
  235.                     used to specify a pathname to locate a command in.
  236.  
  237.                          /C:\perfect\wp
  238.  
  239.                          The above  example would  start the  WP command from
  240.                          the \perfect\ directory.
  241.  
  242.                          /C:del
  243.  
  244.                          The above command would  use the  DOS delete command
  245.                          to delete the file specified.
  246.  
  247.  
  248.           /L        The  /L  parameter  has  no  other values to specify.  It
  249.                     simply causes  WPGRAB  to  select  the  most  recent file
  250.                     processed  and  not  ask  the  user to select a file.  It
  251.                     would be used when you know you want the most recent file
  252.                     processed.
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                           3
  262.  
  263.           /D        WPGRAB normally  builds a DOS batch file with the command
  264.                     to be executed.    A  more  efficient  way  to  start the
  265.                     command  is  to  start  it  while WPGRAB is still active.
  266.                     This is what the /D parameter causes WPGRAB to do.
  267.  
  268.                     The disadvantage here is that about 30K of memory will be
  269.                     used by  WPGRAB and  will not  be available  to your word
  270.                     processor.   If you  have plenty  of memory,  this is the
  271.                     most efficient way to process.
  272.  
  273.  
  274.           /H        Causes WPGRAB to display help information.
  275.  
  276.  
  277.           /SS       The input  pattern name  will be used as a soundex search
  278.                     argument to locate files to list.  A soundex search is an
  279.                     algorithm to find words that sound like the word entered.
  280.                     For example,  if you specify  a pattern  name of  TOM*, a
  281.